home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / u_man / cat1 / vc.z / vc
Encoding:
Text File  |  2002-10-03  |  7.6 KB  |  200 lines
  1.  
  2.  
  3.  
  4. VVVVCCCC((((1111))))                                                                    VVVVCCCC((((1111))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      vc - version control
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      vvvvcccc [----aaaa] [----tttt] [----ccccchar] [----ssss] [keyword=value ... keyword=value]
  13.  
  14. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  15.      The _v_c command copies lines from the standard input to the standard
  16.      output under control of its _a_r_g_u_m_e_n_t_s and _c_o_n_t_r_o_l _s_t_a_t_e_m_e_n_t_s encountered
  17.      in the standard input.  In the process of performing the copy operation,
  18.      user declared _k_e_y_w_o_r_d_s may be replaced by their string _v_a_l_u_e when they
  19.      appear in plain text and/or control statements.
  20.  
  21.      The copying of lines from the standard input to the standard output is
  22.      conditional, based on tests (in control statements) of keyword values
  23.      specified in control statements or as _v_c command arguments.
  24.  
  25.      A control statement is a single line beginning with a control character,
  26.      except as modified by the ----tttt keyletter (see below).  The default control
  27.      character is colon (::::), except as modified by the ----cccc keyletter (see
  28.      below).  Input lines beginning with a backslash (\\\\) followed by a control
  29.      character are not control lines and are copied to the standard output
  30.      with the backslash removed.  Lines beginning with a backslash followed by
  31.      a non-control character are copied in their entirety.
  32.  
  33.      A keyword is composed of 9 or less alphanumerics; the first must be
  34.      alphabetic.  A value is any ASCII string that can be created with _e_d(1);
  35.      a numeric value is an unsigned string of digits.  Keyword values may not
  36.      contain blanks or tabs.
  37.  
  38.      Replacement of keywords by values is done whenever a keyword surrounded
  39.      by control characters is encountered on a version control statement.  The
  40.      ----aaaa keyletter (see below) forces replacement of keywords in _a_l_l lines of
  41.      text.  An uninterpreted control character may be included in a value by
  42.      preceding it with \\\\.  If a literal \\\\ is desired, then it too must be
  43.      preceded by \\\\.
  44.  
  45.      KKKKeeeeyyyylllleeeetttttttteeeerrrr AAAArrrrgggguuuummmmeeeennnnttttssss
  46.  
  47.      ----aaaa          Forces replacement of keywords surrounded by control
  48.                  characters with their assigned value in _a_l_l text lines and
  49.                  not just in _v_c statements.
  50.  
  51.      ----tttt          All characters from the beginning of a line up to and
  52.                  including the first _t_a_b character are ignored for the purpose
  53.                  of detecting a control statement.  If one is found, all
  54.                  characters up to and including the _t_a_b are discarded.
  55.  
  56.      ----ccccchar      Specifies a control character to be used in place of ::::.
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. VVVVCCCC((((1111))))                                                                    VVVVCCCC((((1111))))
  71.  
  72.  
  73.  
  74.      ----ssss          Silences warning messages (not error) that are normally
  75.                  printed on the diagnostic output.
  76.  
  77.      VVVVeeeerrrrssssiiiioooonnnn CCCCoooonnnnttttrrrroooollll SSSSttttaaaatttteeeemmmmeeeennnnttttssss
  78.  
  79.      ::::dcl keyword[, ............, keyword]
  80.           Used to declare keywords.  All keywords must be declared.
  81.  
  82.      ::::asg keyword=value
  83.           Used to assign values to keywords.  An aaaassssgggg statement overrides the
  84.           assignment for the corresponding keyword on the _v_c command line and
  85.           all previous aaaassssgggg's for that keyword.  Keywords declared, but not
  86.           assigned values have null values.
  87.           ::::if condition
  88.                .
  89.                .
  90.                .
  91.           ::::end
  92.           Used to skip lines of the standard input. If the condition is true
  93.           all lines between the _i_f statement and the matching _e_n_d statement
  94.           are copied to the standard output.  If the condition is false, all
  95.           intervening lines are discarded, including control statements.  Note
  96.           that intervening _i_f statements and matching _e_n_d statements are
  97.           recognized solely for the purpose of maintaining the proper _i_f-_e_n_d
  98.           matching.
  99.           The syntax of a condition is::::
  100.  
  101.            <cond>  ::::::::= [ "not" ] <or>
  102.            <or>    ::::::::= <and> | <and> "|" <or>
  103.            <and>   ::::::::= <exp> | <exp> "&" <and>
  104.            <exp>   ::::::::= "(" <or> ")" | <value> <op> <value>
  105.            <op>    ::::::::= "=" | "!=" | "<" | ">"
  106.            <value> ::::::::= <arbitrary ASCII string> | <numeric string>
  107.  
  108.           The available operators and their meanings are::::
  109.  
  110.              =      equal
  111.              !=     not equal
  112.              &      and
  113.              |      or
  114.              >      greater than
  115.              <      less than
  116.              ( )    used for logical groupings
  117.              not    may only occur immediately after the _i_f, and
  118.                     when present, inverts the value of the
  119.                     entire condition
  120.  
  121.           The >>>> and <<<< operate only on unsigned integer values (e.g., :::: 012 >
  122.           12 is false).  All other operators take strings as arguments (e.g.,
  123.           :::: 012 != 12 is true).  The precedence of the operators (from highest
  124.           to lowest) is::::
  125.              = != > <      all of equal precedence
  126.              &
  127.              |
  128.  
  129.  
  130.                                                                         PPPPaaaaggggeeee 2222
  131.  
  132.  
  133.  
  134.  
  135.  
  136.  
  137. VVVVCCCC((((1111))))                                                                    VVVVCCCC((((1111))))
  138.  
  139.  
  140.  
  141.           Parentheses may be used to alter the order of precedence.
  142.           Values must be separated from operators or parentheses by at least
  143.           one blank or tab.
  144.  
  145.      ::::::::text
  146.           Used for keyword replacement on lines that are copied to the
  147.           standard output.  The two leading control characters are removed,
  148.           and keywords surrounded by control characters in text are replaced
  149.           by their value before the line is copied to the output file.  This
  150.           action is independent of the ----aaaa keyletter.
  151.  
  152.      ::::on
  153.  
  154.      ::::off
  155.           Turn on or off keyword replacement on all lines.
  156.  
  157.      ::::ctl char
  158.           Change the control character to char.
  159.  
  160.      ::::msg message
  161.           Prints the given message on the diagnostic output.
  162.  
  163.      ::::err message
  164.           Prints the given message followed by::::
  165.                EEEERRRRRRRROOOORRRR:::: err statement on line ............ (915)
  166.           on the diagnostic output.  _v_c halts execution, and returns an exit
  167.           code of 1.
  168.  
  169. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  170.      ed(1), help(1)
  171.  
  172. DDDDIIIIAAAAGGGGNNNNOOOOSSSSTTTTIIIICCCCSSSS
  173.      Use _h_e_l_p(1) for explanations.
  174.  
  175. EEEEXXXXIIIITTTT CCCCOOOODDDDEEEESSSS
  176.      0 - normal
  177.      1 - any error
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.  
  196.                                                                         PPPPaaaaggggeeee 3333
  197.  
  198.  
  199.  
  200.